<!DOCTYPE html>
<!-- Generated by pkgdown: do not edit by hand --><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><title>radius_inferred - utility to estimate original radius requested in getblocksnearby() if we only have the outputs of getblocksnearby() — radius_inferred • EJAM</title><!-- favicons --><link rel="icon" type="image/png" sizes="16x16" href="../favicon-16x16.png"><link rel="icon" type="image/png" sizes="32x32" href="../favicon-32x32.png"><link rel="apple-touch-icon" type="image/png" sizes="180x180" href="../apple-touch-icon.png"><link rel="apple-touch-icon" type="image/png" sizes="120x120" href="../apple-touch-icon-120x120.png"><link rel="apple-touch-icon" type="image/png" sizes="76x76" href="../apple-touch-icon-76x76.png"><link rel="apple-touch-icon" type="image/png" sizes="60x60" href="../apple-touch-icon-60x60.png"><script src="../deps/jquery-3.6.0/jquery-3.6.0.min.js"></script><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><link href="../deps/bootstrap-5.3.1/bootstrap.min.css" rel="stylesheet"><script src="../deps/bootstrap-5.3.1/bootstrap.bundle.min.js"></script><link href="../deps/font-awesome-6.4.2/css/all.min.css" rel="stylesheet"><link href="../deps/font-awesome-6.4.2/css/v4-shims.min.css" rel="stylesheet"><script src="../deps/headroom-0.11.0/headroom.min.js"></script><script src="../deps/headroom-0.11.0/jQuery.headroom.min.js"></script><script src="../deps/bootstrap-toc-1.0.1/bootstrap-toc.min.js"></script><script src="../deps/clipboard.js-2.0.11/clipboard.min.js"></script><script src="../deps/search-1.0.0/autocomplete.jquery.min.js"></script><script src="../deps/search-1.0.0/fuse.min.js"></script><script src="../deps/search-1.0.0/mark.min.js"></script><!-- pkgdown --><script src="../pkgdown.js"></script><meta property="og:title" content="radius_inferred - utility to estimate original radius requested in getblocksnearby() if we only have the outputs of getblocksnearby() — radius_inferred"><meta name="description" content="radius_inferred - utility to estimate original radius requested in getblocksnearby()
if we only have the outputs of getblocksnearby()"><meta property="og:description" content="radius_inferred - utility to estimate original radius requested in getblocksnearby()
if we only have the outputs of getblocksnearby()"><meta property="og:image" content="https://usepa.github.io/EJAM/logo.svg"></head><body>
    <a href="#main" class="visually-hidden-focusable">Skip to contents</a>


    <nav class="navbar navbar-expand-lg fixed-top bg-light" data-bs-theme="light" aria-label="Site navigation"><div class="container">

    <a class="navbar-brand me-2" href="../index.html">EJAM</a>

    <small class="nav-text text-warning me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">2.32.0</small>


    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>

    <div id="navbar" class="collapse navbar-collapse ms-3">
      <ul class="navbar-nav me-auto"><li class="active nav-item"><a class="nav-link" href="../reference/index.html">Reference</a></li>
<li class="nav-item dropdown">
  <button class="nav-link dropdown-toggle" type="button" id="dropdown-articles" data-bs-toggle="dropdown" aria-expanded="false" aria-haspopup="true">Articles</button>
  <ul class="dropdown-menu" aria-labelledby="dropdown-articles"><li><hr class="dropdown-divider"></li>
    <li><h6 class="dropdown-header" data-toc-skip>Overview for EJAM Users</h6></li>
    <li><a class="dropdown-item" href="../articles/0_whatis.html">What is EJAM</a></li>
    <li><a class="dropdown-item" href="../articles/0_webapp.html">Using EJAM</a></li>
    <li><hr class="dropdown-divider"></li>
    <li><h6 class="dropdown-header" data-toc-skip>For analysts using R</h6></li>
    <li><a class="dropdown-item" href="../articles/1_installing.html">Installing the EJAM R package</a></li>
    <li><a class="dropdown-item" href="../articles/2_quickstart.html">Quick Start Guide</a></li>
    <li><a class="dropdown-item" href="../articles/3_analyzing.html">Basics of Using EJAM for Analysis in RStudio</a></li>
    <li><a class="dropdown-item" href="../articles/4_advanced.html">Advanced Features</a></li>
  </ul></li>
<li class="nav-item"><a class="nav-link" href="../news/index.html">Changelog</a></li>
      </ul><ul class="navbar-nav"><li class="nav-item"><form class="form-inline" role="search">
 <input class="form-control" type="search" name="search-input" id="search-input" autocomplete="off" aria-label="Search site" placeholder="Search for" data-search-index="../search.json"></form></li>
<li class="nav-item"><a class="external-link nav-link" href="https://github.com/USEPA/EJAM/" aria-label="GitHub"><span class="fa fab fa-github fa-lg"></span></a></li>
      </ul></div>


  </div>
</nav><div class="container template-reference-topic">
<div class="row">
  <main id="main" class="col-md-9"><div class="page-header">
      <img src="../logo.svg" class="logo" alt=""><h1>radius_inferred - utility to estimate original radius requested in getblocksnearby() if we only have the outputs of getblocksnearby()</h1>
      <small class="dont-index">Source: <a href="https://github.com/USEPA/EJAM/blob/HEAD/R/radius_inferred.R" class="external-link"><code>R/radius_inferred.R</code></a></small>
      <div class="d-none name"><code>radius_inferred.Rd</code></div>
    </div>

    <div class="ref-description section level2">
    <p>radius_inferred - utility to estimate original radius requested in getblocksnearby()
if we only have the outputs of getblocksnearby()</p>
    </div>

    <div class="section level2">
    <h2 id="ref-usage">Usage<a class="anchor" aria-label="anchor" href="#ref-usage"></a></h2>
    <div class="sourceCode"><pre class="sourceCode r"><code><span><span class="fu">radius_inferred</span><span class="op">(</span></span>
<span>  s2b <span class="op">=</span> <span class="cn">NULL</span>,</span>
<span>  decimalsreported <span class="op">=</span> <span class="fl">2</span>,</span>
<span>  decimalsforinferring <span class="op">=</span> <span class="fl">3</span>,</span>
<span>  pctile_of_sites <span class="op">=</span> <span class="fl">0.9</span>,</span>
<span>  nth_furthest_block <span class="op">=</span> <span class="fl">2</span></span>
<span><span class="op">)</span></span></code></pre></div>
    </div>

    <div class="section level2">
    <h2 id="arguments">Arguments<a class="anchor" aria-label="anchor" href="#arguments"></a></h2>


<dl><dt id="arg-s-b">s2b<a class="anchor" aria-label="anchor" href="#arg-s-b"></a></dt>
<dd><p>data.table of ejam_uniq_id, distance, etc. that is the output of getblocksnearby()</p></dd>


<dt id="arg-decimalsreported">decimalsreported<a class="anchor" aria-label="anchor" href="#arg-decimalsreported"></a></dt>
<dd><p>parameter to fine tune estimates - generally should not be changed</p></dd>


<dt id="arg-decimalsforinferring">decimalsforinferring<a class="anchor" aria-label="anchor" href="#arg-decimalsforinferring"></a></dt>
<dd><p>parameter to fine tune estimates - generally should not be changed</p></dd>


<dt id="arg-pctile-of-sites">pctile_of_sites<a class="anchor" aria-label="anchor" href="#arg-pctile-of-sites"></a></dt>
<dd><p>parameter to fine tune estimates - generally should not be changed</p></dd>


<dt id="arg-nth-furthest-block">nth_furthest_block<a class="anchor" aria-label="anchor" href="#arg-nth-furthest-block"></a></dt>
<dd><p>parameter to fine tune estimates - generally should not be changed</p></dd>

</dl></div>
    <div class="section level2">
    <h2 id="value">Value<a class="anchor" aria-label="anchor" href="#value"></a></h2>
    <p>a single number such as 1.5 or 3 that is the estimate of the miles distance that was
originally requested in getblocksnearby()</p>
    </div>
    <div class="section level2">
    <h2 id="details">Details<a class="anchor" aria-label="anchor" href="#details"></a></h2>
    <p>There are some cases where someone using EJAM functions like getblocksnearby()
might in a later separate step use the results of getblocksnearby() to summarize
indicator values using a function like doaggregate(), and the actual radius originally
requested is not known.</p>
<p>This function tries to approximate what radius must have been requested for analysis,
looking at the sites2blocks information about distances to all nearby blocks
near each of the analyzed sites. It is not as simple as using the max distance over all sites,
because at some sites getblocksnearby() reports one or two distances larger than
radius requested, even if avoidorphans is FALSE. That must be because the
reported distance is adjusted when it is small relative to the whole block, to
better estimate distance to average resident in the block rather than reporting
distance to the point that is the block internal point (centroid essentially).
As documented in the EJScreen information about creating proximity scores,
a facility exactly on top of the block internal point has distance zero to the point but
that is not the actual distance to the average resident in the block, hence the adjustment.
Some blocks in low density areas are huge so a relatively small circular buffer (small radius)
will require adjustments more often. If the block is 3 miles in radius but someone wants a
radius of 1 mile in getblocksnearby() or ejamit() analysis overall, a site inside the block
might be reported as having a distance of 2.7 miles because the average resident in the block
is estimated to be 2.7 miles away from any site in the block. Almost 2% of US blocks are
affected by this issue for a selected radius of 1 mile, but only 1 in 1,000 are for a radius of 3 miles.</p>
<p>This function is based largely on a practical algorithm that is accurate to within 0.01 miles
the vast majority of the time for a radius of 1 to 3 miles.</p>
    </div>

    <div class="section level2">
    <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-examples"></a></h2>
    <div class="sourceCode"><pre class="sourceCode r"><code><span> <span class="fu">radius_inferred</span><span class="op">(</span><span class="op">)</span></span>
<span>  <span class="co"># radius_inferred(getblocksnearby(testpoints_n(100), radius = 3.25))</span></span>
<span>  </span></code></pre></div>
    </div>
  </main><aside class="col-md-3"><nav id="toc" aria-label="Table of contents"><h2>On this page</h2>
    </nav></aside></div>


    <footer><div class="pkgdown-footer-left">
  <p>US EPA 2024</p>
</div>

<div class="pkgdown-footer-right">
  <p>EJAM Version 2.32.0</p>
</div>

    </footer></div>





  </body></html>

